_=<#2285#>#tex2html_accent_inline5190#<#2285#> &sstarf#star;=<#2286#>#tex2html_accent_inline5191#<#2286#> ||=<#2287#>#tex2html_accent_inline5192#<#2287#>

=`
{=`{ }=`}

<#1953#>/<#56#>#tex2html_accent_inline5193#<#56#> <#1953#> =

=0.44

=.10

=0em

=<#2288#>

`@ =

-1pt 201

@dim 202 @indent @siz @box

`@ = #./varmacro.tex#

=0pt 221

<#2291#>=

This reference card describes the available library functions of GNU C on the Atari ST and is currently based on the library from Jwahar~R. Bammi at patchlevel 83. For the most part the functions are alphabetically sorted by function name.

Some of the mentioned functions are only available, when MiNT, the TOS multitasking extension from Eric~R. Smith is running, or if you have a TT. The earlier are marked with ``(MiNT)'', the latter with ``(TT)''.

Additionally, this reference card is postcard-ware. If you find it useful, send a postcard to this address: Frank Ridderbusch, Sander Str.~17, W-4790~Paderborn, Germany.

<#2293#>Standard I/O<#2293#>

<#2294#>#tex2html_accent_inline5194#<#2294#><#2296#>section<#2296#><#2297#>Standard I/O<#2297#><#2298#><#2298#>

#include stdio.h;SPMgt;

<#124#>=The following aliases for some of the below functions are defined.

<#124#>

= to <#1971#>#=10pt plus 1 fil;SPMamp;# getc;SPMamp;fgetc ungetc;SPMamp;fungetc putc;SPMamp;fputc getchar();SPMamp;fgetc(stdin) ungetchar(c);SPMamp;fungetc((c),stdin) putchar(c);SPMamp;fputc((c),stdout) <#1971#>=0em

func@star<#137#>void clearerr(FILE &sstarf#star;fp);<#137#> =2000 to <#2299#> <#2300#>by -Clear error and EOF status of stream <#2301#>#tex2html_accent_inline5195#<#2301#>. (Macro)<#2300#><#2299#>

func@star<#139#>char &sstarf#star;ctermid(char &sstarf#star;name);<#139#> =2000 to <#2302#> <#2303#>by -<#2303#><#2302#>

func@star<#141#>int fclose(FILE &sstarf#star;fp);<#141#> =2000 to <#2304#> <#2305#>by -Close the stream <#2306#>#tex2html_accent_inline5196#<#2306#>.<#2305#><#2304#>

func@star<#143#>FILE &sstarf#star;fdopen(int fd, const~char &sstarf#star;mode);<#143#> =2000 to <#2307#> <#2308#>by -Connect a file pointer to the file descriptor <#2309#>#tex2html_accent_inline5197#<#2309#> with mode <#2310#>#tex2html_accent_inline5198#<#2310#>.<#2308#><#2307#>

func@star<#146#>int feof(FILE &sstarf#star;fp);<#146#> =2000 to <#2311#> <#2312#>by -Test EOF status of stream <#2313#>#tex2html_accent_inline5199#<#2313#>. (Macro)<#2312#><#2311#>

func@star<#148#>int ferror(FILE &sstarf#star;fp);<#148#> =2000 to <#2314#> <#2315#>by -Test error status of stream <#2316#>#tex2html_accent_inline5200#<#2316#>. (Macro)<#2315#><#2314#>

func@star<#150#>int fflush(FILE &sstarf#star;fp);<#150#> =2000 to <#2317#> <#2318#>by -Write data from internal buffer of stream <#2319#>#tex2html_accent_inline5201#<#2319#> to the file.<#2318#><#2317#>

func@star<#152#>int fgetc(FILE &sstarf#star;fp);<#152#> =2000 to <#2320#> <#2321#>by -Get a character from stream <#2322#>#tex2html_accent_inline5202#<#2322#>.<#2321#><#2320#>

func@star<#154#>int fgetpos(FILE &sstarf#star;fp, fpos_t &sstarf#star;ptr);<#154#> =2000 to <#2323#> <#2324#>by -Put the current position of the file pointer of stream <#2325#>#tex2html_accent_inline5203#<#2325#> into the address <#2326#>#tex2html_accent_inline5204#<#2326#>.<#2324#><#2323#>

func@star<#157#>char &sstarf#star;fgets(char &sstarf#star;buf, int max, FILE &sstarf#star;fp);<#157#> =2000 to <#2327#> <#2328#>by -Get a string including the NL character from stream <#2329#>#tex2html_accent_inline5205#<#2329#> with <#2330#>#tex2html_accent_inline5206#<#2330#> byte into <#2331#>#tex2html_accent_inline5207#<#2331#>.<#2328#><#2327#>

func@star<#161#>int fileno(FILE &sstarf#star;fp);<#161#> =2000 to <#2332#> <#2333#>by -Get file descriptor of stream <#2334#>#tex2html_accent_inline5208#<#2334#>. (Macro)<#2333#><#2332#>

func@star<#163#>FILE &sstarf#star;fopen(const~char &sstarf#star;fname, const~char &sstarf#star;mode);<#163#> =2000 to <#2335#> <#2336#>by -Open file <#2337#>#tex2html_accent_inline5209#<#2337#> with mode <#2338#>#tex2html_accent_inline5210#<#2338#> for stream I/O.<#2336#><#2335#>

func@star<#166#>int fputc(int c, FILE &sstarf#star;fp);<#166#> =2000 to <#2339#> <#2340#>by -Write a character <#2341#>#tex2html_accent_inline5211#<#2341#> into stream <#2342#>#tex2html_accent_inline5212#<#2342#>.<#2340#><#2339#>

func@star<#169#>int fputs(const~char &sstarf#star;buf, FILE &sstarf#star;fp);<#169#> =2000 to <#2343#> <#2344#>by -Write the string in <#2345#>#tex2html_accent_inline5213#<#2345#> into stream <#2346#>#tex2html_accent_inline5214#<#2346#>.<#2344#><#2343#>

func@star<#172#>size_t fread(void &sstarf#star;buf, size_t sz, size_t no, FILE &sstarf#star;fp);<#172#> =2000 to <#2347#> <#2348#>by -Read <#2349#>#tex2html_accent_inline5215#<#2349#> items of size <#2350#>#tex2html_accent_inline5216#<#2350#> from stream <#2351#>#tex2html_accent_inline5217#<#2351#> into <#2352#>#tex2html_accent_inline5218#<#2352#>.<#2348#><#2347#>

func@star<#177#>FILE &sstarf#star;freopen(const~char &sstarf#star;fname, const~char &sstarf#star;mode, FILE &sstarf#star;fp);<#177#> =2000 to <#2353#> <#2354#>by -Reopen <#2355#>#tex2html_accent_inline5219#<#2355#> with file <#2356#>#tex2html_accent_inline5220#<#2356#> and mode <#2357#>#tex2html_accent_inline5221#<#2357#>.<#2354#><#2353#>

func@star<#181#>int fseek(FILE &sstarf#star;fp, long pos, int whence);<#181#> =2000 to <#2358#> <#2359#>by -Move the the file pointer from stream <#2360#>#tex2html_accent_inline5222#<#2360#> to position <#2361#>#tex2html_accent_inline5223#<#2361#> relativ to <#2362#>#tex2html_accent_inline5224#<#2362#>.<#2359#><#2358#>

func@star<#185#>int fsetpos(FILE &sstarf#star;fp, fpos_t &sstarf#star;ptr);<#185#> =2000 to <#2363#> <#2364#>by -Set the position of the file pointer of stream <#2365#>#tex2html_accent_inline5225#<#2365#> to the value at address <#2366#>#tex2html_accent_inline5226#<#2366#>.<#2364#><#2363#>

func@star<#188#>long ftell(FILE &sstarf#star;fp);<#188#> =2000 to <#2367#> <#2368#>by -Get the current position of the file pointer from stream <#2369#>#tex2html_accent_inline5227#<#2369#>.<#2368#><#2367#>

func@star<#190#>int fungetc(int c, FILE &sstarf#star;fp);<#190#> =2000 to <#2370#> <#2371#>by -Push the character <#2372#>#tex2html_accent_inline5228#<#2372#> back onto stream <#2373#>#tex2html_accent_inline5229#<#2373#>.<#2371#><#2370#>

func@star<#193#>size_t fwrite(const~void &sstarf#star;buf, size_t size, size_t no , FILE &sstarf#star;fp);<#193#> =2000 to <#2374#> <#2375#>by -Write <#2376#>#tex2html_accent_inline5230#<#2376#> items of size <#2377#>#tex2html_accent_inline5231#<#2377#> from <#2378#>#tex2html_accent_inline5232#<#2378#> into stream <#2379#>#tex2html_accent_inline5233#<#2379#>.<#2375#><#2374#>

func@star<#198#>long getl(FILE &sstarf#star;fp);<#198#> =2000 to <#2380#> <#2381#>by -Read a long value from stream <#2382#>#tex2html_accent_inline5234#<#2382#>.<#2381#><#2380#>

func@star<#200#>char &sstarf#star;gets(char &sstarf#star;buf);<#200#> =2000 to <#2383#> <#2384#>by -Get a string from stdin;SPMgt; into <#2385#>#tex2html_accent_inline5235#<#2385#>. The NL character is discarded.<#2384#><#2383#>

func@star<#202#>short getw(FILE &sstarf#star;fp);<#202#> =2000 to <#2386#> <#2387#>by -Read a short value from stream <#2388#>#tex2html_accent_inline5236#<#2388#>.<#2387#><#2386#>

func@star<#204#>int pclose(FILE &sstarf#star;fp);<#204#> =2000 to <#2389#> <#2390#>by -Close the stream created by <#2391#>#tex2html_accent_inline5237#<#2391#>.<#2390#><#2389#>

func@star<#206#>void perror(const~char &sstarf#star;str);<#206#> =2000 to <#2392#> <#2393#>by -Display error message starting with <#2394#>#tex2html_accent_inline5238#<#2394#> depending on <#2395#>#tex2html_accent_inline5239#<#2395#>.<#2393#><#2392#>

func@star<#209#>FILE &sstarf#star;popen(const~char &sstarf#star;command, const~char &sstarf#star;mode);<#209#> =2000 to <#2396#> <#2397#>by -Open a pipe with <#2398#>#tex2html_accent_inline5240#<#2398#> to <#2399#>#tex2html_accent_inline5241#<#2399#>. (Faked by temporary files)<#2397#><#2396#>

func@star<#212#>int printf(const~char &sstarf#star;fmt, …);<#212#> func@star<#213#>int fprintf(FILE &sstarf#star;fp, const~char &sstarf#star;fmt, …);<#213#> func@star<#214#>int sprintf(char &sstarf#star;buf, const~char &sstarf#star;fmt, …);<#214#> func@star<#215#>int vprintf(const~char &sstarf#star;fmt, char &sstarf#star;);<#215#> func@star<#216#>int vfprintf(FILE &sstarf#star;fp, const~char &sstarf#star;fmt, char &sstarf#star;);<#216#> func@star<#217#>int vsprintf(char &sstarf#star;buf, const~char &sstarf#star;fmt, char &sstarf#star;);<#217#> =2000 to <#2400#> <#2401#>by -Formated output to either stdout;SPMgt;, <#2402#>#tex2html_accent_inline5245#<#2402#> or <#2403#>#tex2html_accent_inline5246#<#2403#> with fixed or variable number of arguments.<#2401#><#2400#>

<#1999#>=The following table lists the identifying letters of the <#220#>#tex2html_accent_inline5247#<#220#> string.

<#1999#>

= #1##2##3<#2405#>##1;SPMamp;;SPMamp;##2;SPMamp;;SPMamp;##3<#2405#> ;SPMnbsp;;SPMnbsp;;SPMnbsp;;SPMnbsp;##;SPMnbsp;;SPMnbsp;;SPMnbsp;;SPMnbsp;;SPMamp;##;SPMamp; ;SPMnbsp;;SPMnbsp;;SPMnbsp;;SPMnbsp;##;SPMnbsp;;SPMnbsp;;SPMnbsp;;SPMnbsp;;SPMamp;##;SPMamp;;SPMnbsp;;SPMnbsp;;SPMnbsp;;SPMnbsp;## ;SPMamp;scanf;SPMamp;;SPMamp;printf;SPMamp;;SPMamp;Meaning;SPMamp; <#224#>

func@star<#297#>long putl(long c, FILE &sstarf#star;fp);<#297#> =2000 to <#2407#> <#2408#>by -Output the long value <#2409#>#tex2html_accent_inline5254#<#2409#> into the stream <#2410#>#tex2html_accent_inline5255#<#2410#>.<#2408#><#2407#>

func@star<#300#>int puts(const~char &sstarf#star;buf);<#300#> =2000 to <#2411#> <#2412#>by -Write the string in <#2413#>#tex2html_accent_inline5256#<#2413#> to stdout;SPMgt; appending a NL character.<#2412#><#2411#>

func@star<#302#>short putw(short c, FILE &sstarf#star;fp);<#302#> =2000 to <#2414#> <#2415#>by -Output the short value <#2416#>#tex2html_accent_inline5257#<#2416#> into the stream <#2417#>#tex2html_accent_inline5258#<#2417#>.<#2415#><#2414#>

func@star<#305#>int remove(const~char &sstarf#star;fname);<#305#> =2000 to <#2418#> <#2419#>by -Remove file with name <#2420#>#tex2html_accent_inline5259#<#2420#>.<#2419#><#2418#>

func@star<#307#>int rename(const~char &sstarf#star;old, const~char &sstarf#star;new);<#307#> =2000 to <#2421#> <#2422#>by -Change name of file from <#2423#>#tex2html_accent_inline5260#<#2423#> to <#2424#>#tex2html_accent_inline5261#<#2424#>.<#2422#><#2421#>

func@star<#310#>void rewind(FILE &sstarf#star;fp);<#310#> =2000 to <#2425#> <#2426#>by -Reset the filepointer from stream <#2427#>#tex2html_accent_inline5262#<#2427#> to position 0.<#2426#><#2425#>

func@star<#312#>int scanf(const~char &sstarf#star;fmt, …);<#312#> func@star<#313#>int fscanf(FILE &sstarf#star;fp, const~char &sstarf#star;fmt, …);<#313#> func@star<#314#>int sscanf(const~char &sstarf#star;buf, const~char &sstarf#star;fmt, …);<#314#> =2000 to <#2428#> <#2429#>by -Formated input from either stdin;SPMgt;, <#2430#>#tex2html_accent_inline5266#<#2430#> or <#2431#>#tex2html_accent_inline5267#<#2431#>. (For a description of the letters in the <#2432#>#tex2html_accent_inline5268#<#2432#> string see <#2433#>#tex2html_accent_inline5269#<#2433#>.)<#2429#><#2428#>

func@star<#319#>void setbuf(FILE &sstarf#star;fp, char &sstarf#star;buf);<#319#> =2000 to <#2434#> <#2435#>by -Set buffer of stream <#2436#>#tex2html_accent_inline5270#<#2436#> to <#2437#>#tex2html_accent_inline5271#<#2437#>.<#2435#><#2434#>

The following functions are defined as macros.

func@star<#322#>int setvbuf(FILE &sstarf#star;fp, char &sstarf#star;buf, int mode, size_t sz);<#322#> =2000 to <#2438#> <#2439#>by -Set buffer of stream <#2440#>#tex2html_accent_inline5272#<#2440#> to <#2441#>#tex2html_accent_inline5273#<#2441#> with size <#2442#>#tex2html_accent_inline5274#<#2442#> and mode <#2443#>#tex2html_accent_inline5275#<#2443#>.<#2439#><#2438#>

func@star<#327#>FILE &sstarf#star;tmpfile(void);<#327#> =2000 to <#2444#> <#2445#>by -Create a temporary file. File is deleted on normal termination.<#2445#><#2444#>

func@star<#329#>char &sstarf#star;tmpnam(char &sstarf#star;buf);<#329#> =2000 to <#2446#> <#2447#>by -Create a string for a temporary filename.<#2447#><#2446#>

func@star<#331#>void _binmode(int bool);<#331#> =2000 to <#2448#> <#2449#>by -Set default open mode to binary (bool = true) or text.<#2449#><#2448#>

<#2450#>I/O Control<#2450#>

<#2451#>#tex2html_accent_inline5276#<#2451#><#2453#>section<#2453#><#2454#>I/O Control<#2454#><#2455#><#2455#>

#include ioctl.h;SPMgt;

func@star<#334#>int ioctl(int fd, int cmd, void &sstarf#star;arg);<#334#> =2000 to <#2456#> <#2457#>by -Set or inquire i/o dependend parameter.<#2457#><#2456#>

func@star<#336#>int stty(int fd, struct sgttyb &sstarf#star;_tty);<#336#> func@star<#337#>int gtty(int fd, struct sgttyb &sstarf#star;_tty);<#337#> =2000 to <#2458#> <#2459#>by -Set or inquire i/o parameters for descriptor <#2460#>#tex2html_accent_inline5277#<#2460#>.<#2459#><#2458#>

#include fcntl.h;SPMgt;

func@star<#339#>int fcntl(int fd, int cmd, …);<#339#> =2000 to <#2461#> <#2462#>by -Set or inquire file i/o dependend parameter (MiNT).<#2462#><#2461#>

<#2463#>Memory Management<#2463#>

<#2464#>#tex2html_accent_inline5279#<#2464#><#2466#>section<#2466#><#2467#>Memory Management<#2467#><#2468#><#2468#>

#include stdlib.h;SPMgt;

func@star<#342#>void &sstarf#star;calloc(size_t no, size_t sz);<#342#> =2000 to <#2469#> <#2470#>by -Allocate and initialize memory for <#2471#>#tex2html_accent_inline5280#<#2471#> items of size <#2472#>#tex2html_accent_inline5281#<#2472#>.<#2470#><#2469#>

func@star<#345#>void &sstarf#star;malloc(size_t sz);<#345#> =2000 to <#2473#> <#2474#>by -Allocate <#2475#>#tex2html_accent_inline5282#<#2475#> bytes of memory.<#2474#><#2473#>

func@star<#347#>void &sstarf#star;realloc(void &sstarf#star;ptr, size_t sz);<#347#> =2000 to <#2476#> <#2477#>by -Resize memory pointed to by <#2478#>#tex2html_accent_inline5283#<#2478#> to size <#2479#>#tex2html_accent_inline5284#<#2479#>.<#2477#><#2476#>

func@star<#350#>void free(void &sstarf#star;ptr);<#350#> =2000 to <#2480#> <#2481#>by -Free memory obtained by <#2482#>#tex2html_accent_inline5285#<#2482#>, <#2483#>#tex2html_accent_inline5286#<#2483#> or <#2484#>#tex2html_accent_inline5287#<#2484#>.<#2481#><#2480#>

func@star<#354#>void &sstarf#star;alloca(size_t sz);<#354#> =2000 to <#2485#> <#2486#>by -Allocate <#2487#>#tex2html_accent_inline5288#<#2487#> bytes from the current function stack.<#2486#><#2485#>

func@star<#356#>void _malloczero(int bool);<#356#> =2000 to <#2488#> <#2489#>by -Zero allocated memory blocks. Default = = false.<#2489#><#2488#>

func@star<#358#>void _mallocChunkSize(size_t Siz);<#358#> =2000 to <#2490#> <#2491#>by -Get memory from OS in atleast <#2492#>#tex2html_accent_inline5290#<#2492#> sized blocks. Default = = 4K<#2491#><#2490#>

#include memory.h;SPMgt;

func@star<#360#>void &sstarf#star;_calloc(unsigned~long no, unsigned~long sz);<#360#> func@star<#361#>void &sstarf#star;_malloc(unsigned~long sz);<#361#> func@star<#362#>void &sstarf#star;_realloc(void &sstarf#star;ptr, unsigned~long sz);<#362#> =2000 to <#2493#> <#2494#>by -Apart from the above functions, these three functions are additionally declared in memory.h and take <#2495#>#tex2html_accent_inline5292#<#2495#> arguments.<#2494#><#2493#>

<#2496#>Character Classification and Conversion<#2496#>

<#2497#>#tex2html_accent_inline5293#<#2497#><#2499#>section<#2499#><#2500#>Character Classification and Conversion<#2500#><#2501#><#2501#>

The following functions return ≠ 0, if character <#365#>#tex2html_accent_inline5295#<#365#> belongs to the specified character set; 0 otherwise.

#include ctype.h;SPMgt;

<#2017#><#366#>#tex2html_accent_inline5296#<#366#>(<#367#>#tex2html_accent_inline5297#<#367#>);SPMnbsp;;SPMnbsp;;SPMnbsp;;SPMnbsp;;SPMamp;# function;SPMnbsp;;SPMnbsp;;SPMnbsp;;SPMnbsp;;SPMamp;set<#368#><#368#> isalnum;SPMamp;Letter or Digit isalpha;SPMamp;Letter isascii;SPMamp;ASCII character (Codes: 0…0177) iscntrl;SPMamp;Control character (Codes: 0…037, 0177) isdigit;SPMamp;Digit isgraph;SPMamp;Printable character except space islower;SPMamp;Lowercase letter isprint;SPMamp;Printable character ispunct;SPMamp;Punctuation char. (not letter, digit or control) isspace;SPMamp;Space, Tab, CR, NL, VT, FF or BS isupper;SPMamp;Uppercase letter isxdigit;SPMamp;Hexadecimal digit iswhite;SPMamp;same as ispace() isodigit;SPMamp;Octal digit iscymf;SPMamp;Character starting a C identifier iscym;SPMamp;Characters continuing a C identifier <#2017#>

Character conversion functions

<#2018#><#401#>#tex2html_accent_inline5300#<#401#>(<#402#>#tex2html_accent_inline5301#<#402#>);SPMnbsp;;SPMnbsp;;SPMnbsp;;SPMnbsp;;SPMamp;# function;SPMnbsp;;SPMnbsp;;SPMnbsp;;SPMnbsp;;SPMamp;Meaning<#403#><#403#> toupper;SPMamp;Convert to uppercase letter _toupper;SPMamp;Convert to uppercase letter (macro) tolower;SPMamp;Convert to lowercase letter _tolower;SPMamp;Convert to lowercase letter (macro) toint;SPMamp;Convert digit to integer <#2018#>

<#2502#>String Handling<#2502#>

<#2503#>#tex2html_accent_inline5302#<#2503#><#2505#>section<#2505#><#2506#>String Handling<#2506#><#2507#><#2507#>

#include string.h;SPMgt;

func@star<#415#>int bcmp(const~void &sstarf#star;ptr1, const~void &sstarf#star;ptr2, size_t no);<#415#> =2000 to <#2508#> <#2509#>by -Compare <#2510#>#tex2html_accent_inline5303#<#2510#> of bytes at position <#2511#>#tex2html_accent_inline5304#<#2511#> with <#2512#>#tex2html_accent_inline5305#<#2512#>.<#2509#><#2508#>

func@star<#419#>void bcopy(const~void &sstarf#star;src, void &sstarf#star;dst, size_t len);<#419#> =2000 to <#2513#> <#2514#>by -Copy <#2515#>#tex2html_accent_inline5306#<#2515#> bytes from position <#2516#>#tex2html_accent_inline5307#<#2516#> to <#2517#>#tex2html_accent_inline5308#<#2517#>.<#2514#><#2513#>

func@star<#423#>void bzero(void &sstarf#star;dst, size_t len);<#423#> =2000 to <#2518#> <#2519#>by -Set <#2520#>#tex2html_accent_inline5309#<#2520#> bytes at position <#2521#>#tex2html_accent_inline5310#<#2521#> to 0.<#2519#><#2518#>

func@star<#426#>char &sstarf#star;index(const~char &sstarf#star;str, int charw);<#426#> func@star<#427#>char &sstarf#star;rindex(const~char &sstarf#star;str, int charw);<#427#> =2000 to <#2522#> <#2523#>by -Same as <#2524#>#tex2html_accent_inline5311#<#2524#>() (<#2525#>#tex2html_accent_inline5312#<#2525#>()).<#2523#><#2522#>

func@star<#430#>void &sstarf#star;memccpy(void &sstarf#star;dst, const~void &sstarf#star;src, int ucharstop, size_t no);<#430#> =2000 to <#2526#> <#2527#>by -Copy characters from <#2528#>#tex2html_accent_inline5313#<#2528#> to <#2529#>#tex2html_accent_inline5314#<#2529#> until character <#2530#>#tex2html_accent_inline5315#<#2530#>, but copy at most <#2531#>#tex2html_accent_inline5316#<#2531#> bytes.<#2527#><#2526#>

func@star<#435#>void &sstarf#star;memchr(const~void &sstarf#star;ptr, int ucharwanted, size_t no);<#435#> =2000 to <#2532#> <#2533#>by -Find character <#2534#>#tex2html_accent_inline5317#<#2534#> in area at <#2535#>#tex2html_accent_inline5318#<#2535#>, but compare at most <#2536#>#tex2html_accent_inline5319#<#2536#> character.<#2533#><#2532#>

func@star<#439#>int memcmp(const~void &sstarf#star;ptr1, const~void &sstarf#star;ptr2, size_t no);<#439#> =2000 to <#2537#> <#2538#>by -Compare <#2539#>#tex2html_accent_inline5320#<#2539#> bytes from memory area at <#2540#>#tex2html_accent_inline5321#<#2540#> with area at <#2541#>#tex2html_accent_inline5322#<#2541#>.<#2538#><#2537#>

func@star<#443#>void &sstarf#star;memcpy(void &sstarf#star;dst, const~void &sstarf#star;src, size_t no);<#443#> =2000 to <#2542#> <#2543#>by -Copy <#2544#>#tex2html_accent_inline5323#<#2544#> of bytes from area at <#2545#>#tex2html_accent_inline5324#<#2545#> to <#2546#>#tex2html_accent_inline5325#<#2546#>.<#2543#><#2542#>

func@star<#447#>void &sstarf#star;memset(void &sstarf#star;ptr, int ucharfill, size_t no);<#447#> =2000 to <#2547#> <#2548#>by -Set <#2549#>#tex2html_accent_inline5326#<#2549#> of bytes at position <#2550#>#tex2html_accent_inline5327#<#2550#> to character <#2551#>#tex2html_accent_inline5328#<#2551#>.<#2548#><#2547#>

func@star<#451#>char &sstarf#star;strcat(char &sstarf#star;dst, const~char &sstarf#star;src);<#451#> func@star<#452#>char &sstarf#star;strncat(char &sstarf#star;dst, const~char &sstarf#star;src, size_t no);<#452#> =2000 to <#2552#> <#2553#>by -Concatenate the string at <#2554#>#tex2html_accent_inline5329#<#2554#> to the string at <#2555#>#tex2html_accent_inline5330#<#2555#>. <#2556#>#tex2html_accent_inline5331#<#2556#>() concatenates at most <#2557#>#tex2html_accent_inline5332#<#2557#> characters.<#2553#><#2552#>

func@star<#457#>char &sstarf#star;strchr(const~char &sstarf#star;str, int charw);<#457#> func@star<#458#>char &sstarf#star;strrchr(const~char &sstarf#star;str, int charw);<#458#> =2000 to <#2558#> <#2559#>by -Find first (last) occurence of character <#2560#>#tex2html_accent_inline5333#<#2560#> in string <#2561#>#tex2html_accent_inline5334#<#2561#>.<#2559#><#2558#>

func@star<#461#>int strcmp(const~char &sstarf#star;str1, const~char &sstarf#star;str2);<#461#> func@star<#462#>int strncmp(const~char &sstarf#star;str1, const~char &sstarf#star;str2, size_t no);<#462#> =2000 to <#2562#> <#2563#>by -Compare string <#2564#>#tex2html_accent_inline5335#<#2564#> with string <#2565#>#tex2html_accent_inline5336#<#2565#>. <#2566#>#tex2html_accent_inline5337#<#2566#>() compares at most <#2567#>#tex2html_accent_inline5338#<#2567#> characters.<#2563#><#2562#>

func@star<#467#>char &sstarf#star;strcpy(char &sstarf#star;dst, const~char &sstarf#star;src);<#467#> func@star<#468#>char &sstarf#star;strncpy(char &sstarf#star;dst, const~char &sstarf#star;src, size_t no);<#468#> =2000 to <#2568#> <#2569#>by -Copy string at <#2570#>#tex2html_accent_inline5339#<#2570#> to <#2571#>#tex2html_accent_inline5340#<#2571#>. <#2572#>#tex2html_accent_inline5341#<#2572#>() copies at most <#2573#>sl no<#2573#> characters.<#2569#><#2568#>

func@star<#473#>size_t strcspn(const~char &sstarf#star;str, const~char &sstarf#star;rej);<#473#> =2000 to <#2574#> <#2575#>by -Find length of initial segment of <#2576#>#tex2html_accent_inline5342#<#2576#> consisting entirely of characters not from <#2577#>#tex2html_accent_inline5343#<#2577#>.<#2575#><#2574#>

func@star<#476#>char &sstarf#star;strdup(const~char &sstarf#star;str);<#476#> =2000 to <#2578#> <#2579#>by -Return a duplicate of string <#2580#>#tex2html_accent_inline5344#<#2580#>.<#2579#><#2578#>

func@star<#478#>char &sstarf#star;strerror(int errno);<#478#> =2000 to <#2581#> <#2582#>by -Map error number <#2583#>#tex2html_accent_inline5345#<#2583#> to a descriptive string.<#2582#><#2581#>

func@star<#480#>int stricmp(const~char &sstarf#star;str1, const~char &sstarf#star;str2);<#480#> func@star<#481#>int strcmpi(const~char &sstarf#star;str1, const~char &sstarf#star;str2);<#481#> func@star<#482#>int strnicmp(const~char &sstarf#star;str1, const~char &sstarf#star;str2, size_t no);<#482#> func@star<#483#>int strncmpi(const~char &sstarf#star;str1, const~char &sstarf#star;str2, size_t no);<#483#> =2000 to <#2584#> <#2585#>by -Same as <#2586#>#tex2html_accent_inline5346#<#2586#>() and <#2587#>#tex2html_accent_inline5347#<#2587#>(), except the case is ignored.<#2585#><#2584#>

func@star<#486#>size_t strlen(const~char &sstarf#star;str);<#486#> =2000 to <#2588#> <#2589#>by -Return length of string <#2590#>#tex2html_accent_inline5348#<#2590#>.<#2589#><#2588#>

func@star<#488#>char &sstarf#star;strlwr(char &sstarf#star;str);<#488#> =2000 to <#2591#> <#2592#>by -Change all character from string <#2593#>#tex2html_accent_inline5349#<#2593#> to lowercase.<#2592#><#2591#>

func@star<#490#>char &sstarf#star;strpbrk(const~char &sstarf#star;str, const~char &sstarf#star;breakat);<#490#> =2000 to <#2594#> <#2595#>by -First occurrence of a character from string <#2596#>#tex2html_accent_inline5350#<#2596#> in string <#2597#>#tex2html_accent_inline5351#<#2597#>.<#2595#><#2594#>

func@star<#493#>char &sstarf#star;strrev(char &sstarf#star;str);<#493#> =2000 to <#2598#> <#2599#>by -Reverse all charcters in string <#2600#>#tex2html_accent_inline5352#<#2600#>. First character becomes last character.<#2599#><#2598#>

func@star<#495#>size_t strspn(const~char &sstarf#star;str, const~char &sstarf#star;accept);<#495#> =2000 to <#2601#> <#2602#>by -Find length of initial segment of <#2603#>#tex2html_accent_inline5353#<#2603#> consisting entirely of characters from <#2604#>#tex2html_accent_inline5354#<#2604#>.<#2602#><#2601#>

func@star<#498#>char &sstarf#star;strstr(const~char &sstarf#star;str, const~char &sstarf#star;wanted);<#498#> =2000 to <#2605#> <#2606#>by -Find first occurence of string <#2607#>#tex2html_accent_inline5355#<#2607#> in string <#2608#>#tex2html_accent_inline5356#<#2608#>.<#2606#><#2605#>

func@star<#501#>char &sstarf#star;strtok(char &sstarf#star;str, const~char &sstarf#star;delim);<#501#> =2000 to <#2609#> <#2610#>by -Retrieve fields from string <#2611#>#tex2html_accent_inline5357#<#2611#>, that are delimited by characters from string <#2612#>#tex2html_accent_inline5358#<#2612#>.<#2610#><#2609#>

<#2613#>Process Management<#2613#>

<#2614#>#tex2html_accent_inline5359#<#2614#><#2616#>section<#2616#><#2617#>Process Management<#2617#><#2618#><#2618#>

#include stdlib.h;SPMgt;

func@star<#505#>void abort();<#505#> =2000 to <#2619#> <#2620#>by -Immediatly abort the running program.<#2620#><#2619#>

func@star<#507#>int atexit(void (&sstarf#star;func)());<#507#> =2000 to <#2621#> <#2622#>by -Register a function for execution on termination.<#2622#><#2621#>

func@star<#509#>void exit(int ret);<#509#> =2000 to <#2623#> <#2624#>by -Exit current process with return value <#2625#>#tex2html_accent_inline5360#<#2625#>.<#2624#><#2623#>

func@star<#511#>int system(const~char &sstarf#star;prog);<#511#> =2000 to <#2626#> <#2627#>by -Execute command <#2628#>#tex2html_accent_inline5361#<#2628#> passed as a string.<#2627#><#2626#>

#include process.h;SPMgt;

func@star<#513#>int spawnl(int mode, char &sstarf#star;path, …);<#513#> func@star<#2045#>int spawnv(int mode, char &sstarf#star;path, char <#514#>&sstarf#star;&sstarf#star;<#514#>argv);<#2045#> func@star<#515#>int spawnle(int mode, char &sstarf#star;path, …);<#515#> func@star<#2046#>int spawnve(int mode, char &sstarf#star;path, char <#516#>&sstarf#star;&sstarf#star;<#516#>argv, char <#517#>&sstarf#star;&sstarf#star;<#517#>envp);<#2046#> =2000 to <#2629#> <#2630#>by -Spawn a new process. (Only <#2631#>#tex2html_accent_inline5364#<#2631#> is allowed for <#2632#>#tex2html_accent_inline5365#<#2632#>).<#2630#><#2629#>

func@star<#2048#>int spawnvp(int mode, char &sstarf#star;name, char <#520#>&sstarf#star;&sstarf#star;<#520#>argv);<#2048#> func@star<#521#>int spawnlp(int mode, char &sstarf#star;name, …);<#521#> =2000 to <#2633#> <#2634#>by -Execute a program on the defautl system execution path. (The current directory is always searched first.)<#2634#><#2633#>

<#2635#>Date and Time<#2635#>

<#2636#>#tex2html_accent_inline5367#<#2636#><#2638#>section<#2638#><#2639#>Date and Time<#2639#><#2640#><#2640#>

#include time.h;SPMgt;

func@star<#524#>char &sstarf#star;asctime(const~struct tm &sstarf#star;t);<#524#> =2000 to <#2641#> <#2642#>by -Convert ``time'' structure to a string.<#2642#><#2641#>

func@star<#526#>clock_t clock();<#526#> =2000 to <#2643#> <#2644#>by -Return process time used so far in units of CLK_TCK ticks per second (under TOS, 200 per second).<#2644#><#2643#>

func@star<#528#>char &sstarf#star;ctime(const~time_t &sstarf#star;t);<#528#> =2000 to <#2645#> <#2646#>by -Convert time in seconds since 1970 to a string.<#2646#><#2645#>

func@star<#530#>double difftime(time_t t1, time_t t2);<#530#> =2000 to <#2647#> <#2648#>by -Return difference between two ``time_t'' types.<#2648#><#2647#>

func@star<#532#>struct~tm &sstarf#star;gmtime(const~time_t &sstarf#star;t);<#532#> =2000 to <#2649#> <#2650#>by -Get the Greenwich Mean time.<#2650#><#2649#>

func@star<#534#>struct~tm &sstarf#star;localtime(const~time_t &sstarf#star;t);<#534#> =2000 to <#2651#> <#2652#>by -Convert given time in seconds since 1970 to local time.<#2652#><#2651#>

func@star<#536#>time_t mktime(const~struct tm &sstarf#star;t);<#536#> =2000 to <#2653#> <#2654#>by -Take a time structure and convert it into representation ``seconds since midnight January 1 1970, GMT''.<#2654#><#2653#>

func@star<#538#>size_t strftime(char &sstarf#star;s, size_t maxsize, const~char &sstarf#star;format, const~struct tm &sstarf#star;timeptr);<#538#> =2000 to <#2655#> <#2656#>by -Print formatted information about a given time.<#2656#><#2655#>

func@star<#540#>time_t time(time_t &sstarf#star;t);<#540#> =2000 to <#2657#> <#2658#>by -Return time in seconds since midnight January 1 1970, GMT.<#2658#><#2657#>

func@star<#542#>void tzset();<#542#> =2000 to <#2659#> <#2660#>by -Set the timezone and dst flag to the local rules (depending on environment variable ``TZ'').<#2660#><#2659#>

<#2661#>File and Directory Information<#2661#>

<#2662#>#tex2html_accent_inline5368#<#2662#><#2664#>section<#2664#><#2665#>File and Directory Information<#2665#><#2666#><#2666#>

#include stat.h;SPMgt;

func@star<#545#>int fstat(int fd, struct stat &sstarf#star;info);<#545#> =2000 to <#2667#> <#2668#>by -Obtain information about file assosiated with filedescriptor <#2669#>#tex2html_accent_inline5369#<#2669#>.<#2668#><#2667#>

func@star<#547#>int lstat(const~char &sstarf#star;fname, struct stat &sstarf#star;info);<#547#> =2000 to <#2670#> <#2671#>by -Like <#2672#>#tex2html_accent_inline5370#<#2672#> but return info about <#2673#>#tex2html_accent_inline5371#<#2673#>.<#2671#><#2670#>

func@star<#550#>int stat(const~char &sstarf#star;fname, struct stat &sstarf#star;info);<#550#> =2000 to <#2674#> <#2675#>by -Obtain information about file <#2676#>#tex2html_accent_inline5372#<#2676#>.<#2675#><#2674#>

#include dirent.h;SPMgt;

func@star<#552#>int closedir(DIR &sstarf#star;dirp);<#552#> =2000 to <#2677#> <#2678#>by -Close directory assosiated with <#2679#>#tex2html_accent_inline5373#<#2679#>.<#2678#><#2677#>

func@star<#554#>DIR &sstarf#star;opendir(const~char &sstarf#star;dirname);<#554#> =2000 to <#2680#> <#2681#>by -Open directory <#2682#>#tex2html_accent_inline5374#<#2682#> for reading.<#2681#><#2680#>

func@star<#556#>struct~dirent &sstarf#star;readdir(DIR &sstarf#star;dirp);<#556#> =2000 to <#2683#> <#2684#>by -Read an entry from directory assosiated with <#2685#>#tex2html_accent_inline5375#<#2685#>.<#2684#><#2683#>

func@star<#558#>void rewinddir(DIR &sstarf#star;dirp);<#558#> =2000 to <#2686#> <#2687#>by -Seek to the beginning of directory assosiated with <#2688#>#tex2html_accent_inline5376#<#2688#>.<#2687#><#2686#>

func@star<#560#>void seekdir(DIR &sstarf#star;dirp, off_t loc);<#560#> =2000 to <#2689#> <#2690#>by -Seek to position <#2691#>#tex2html_accent_inline5377#<#2691#> in the directory assosiated with <#2692#>#tex2html_accent_inline5378#<#2692#>.<#2690#><#2689#>

func@star<#563#>off_t telldir(DIR &sstarf#star;dirp);<#563#> =2000 to <#2693#> <#2694#>by -Get the current position in directory assosiated with <#2695#>#tex2html_accent_inline5379#<#2695#>.<#2694#><#2693#>

func@star<#2058#>int alphasort(struct~dirent <#565#>&sstarf#star;&sstarf#star;<#565#>src, struct~dirent <#566#>&sstarf#star;&sstarf#star;<#566#>dst);<#2058#> =2000 to <#2696#> <#2697#>by -<#2697#><#2696#>

#include ftw.h;SPMgt;

func@star<#568#>int ftw(char &sstarf#star;path, int (&sstarf#star;fn)(), int param);<#568#> =2000 to <#2698#> <#2699#>by -Recursively walk tree rooted at <#2700#>#tex2html_accent_inline5380#<#2700#> applying function <#2701#>#tex2html_accent_inline5381#<#2701#>.<#2699#><#2698#>

<#2702#>Regular Expressions<#2702#>

<#2703#>#tex2html_accent_inline5382#<#2703#><#2705#>section<#2705#><#2706#>Regular Expressions<#2706#><#2707#><#2707#>

#include regexp.h;SPMgt;

func@star<#572#>regexp &sstarf#star;regcomp(char &sstarf#star;exp);<#572#> =2000 to <#2708#> <#2709#>by -Compile a regular expression into an internal code.<#2709#><#2708#>

func@star<#574#>int regexec(regexp &sstarf#star;prog, char &sstarf#star;string, int bolflag);<#574#> =2000 to <#2710#> <#2711#>by -Match the previously compiled expression <#2712#>#tex2html_accent_inline5383#<#2712#> against the <#2713#>#tex2html_accent_inline5384#<#2713#>.<#2711#><#2710#>

func@star<#577#>void regsub(regexp &sstarf#star;prog, char &sstarf#star;source, char &sstarf#star;dest);<#577#> =2000 to <#2714#> <#2715#>by -Substitute the previously matched expression <#2716#>#tex2html_accent_inline5385#<#2716#> with <#2717#>#tex2html_accent_inline5386#<#2717#>. The result is copied to <#2718#>#tex2html_accent_inline5387#<#2718#>.<#2715#><#2714#>

func@star<#581#>void regdump(regexp &sstarf#star;r);<#581#> =2000 to <#2719#> <#2720#>by -Dump the regular expression <#2721#>#tex2html_accent_inline5388#<#2721#> onto stdout;SPMgt; in vaguely comprehensible form.<#2720#><#2719#>

<#2722#>Setjmp Signal Stuff<#2722#>

<#2723#>#tex2html_accent_inline5389#<#2723#><#2725#>section<#2725#><#2726#>Setjmp Signal Stuff<#2726#><#2727#><#2727#>

#include setjmp.h;SPMgt;

func@star<#584#>int setjmp(jmp_buf buf);<#584#> =2000 to <#2728#> <#2729#>by -Prepare buffer <#2730#>#tex2html_accent_inline5390#<#2730#> for non local goto via <#2731#>#tex2html_accent_inline5391#<#2731#>().<#2729#><#2728#>

func@star<#587#>void longjmp(jmp_buf buf, int rv);<#587#> =2000 to <#2732#> <#2733#>by -Return to previously saved context <#2734#>#tex2html_accent_inline5392#<#2734#> with return value <#2735#>#tex2html_accent_inline5393#<#2735#>.<#2733#><#2732#>

func@star<#590#>int catch(jmp_buf id, int (*fn)(void));<#590#> =2000 to <#2736#> <#2737#>by -<#2737#><#2736#>

func@star<#592#>void throw(jmp_buf id, int rv);<#592#> =2000 to <#2738#> <#2739#>by -<#2739#><#2738#>

#include signal.h;SPMgt;

func@star<#2065#><#594#>__Sigfunc<#594#> signal(int sig, __Sigfunc func);<#2065#> =2000 to <#2740#> <#2741#>by -Install the handler <#2742#>#tex2html_accent_inline5394#<#2742#> for signal <#2743#>#tex2html_accent_inline5395#<#2743#>.<#2741#><#2740#>

func@star<#597#>int raise(int sig);<#597#> =2000 to <#2744#> <#2745#>by -<#2745#><#2744#>

func@star<#599#>long sigsetmask(long mask);<#599#> =2000 to <#2746#> <#2747#>by -(MiNT)<#2747#><#2746#>

func@star<#601#>long sigblock(long mask);<#601#> =2000 to <#2748#> <#2749#>by -(MiNT)<#2749#><#2748#>

<#2750#>U*IX Compatibility Routines<#2750#>

<#2751#>#tex2html_accent_inline5396#<#2751#><#2753#>section<#2753#><#2754#>U*IX Compatibility Routines<#2754#><#2755#><#2755#>

#include unistd.h;SPMgt;

func@star<#604#>void _exit(int ret);<#604#> =2000 to <#2756#> <#2757#>by -Exit the current process without cleaning up. (This is a <#2758#>#tex2html_accent_inline5397#<#2758#>)<#2757#><#2756#>

func@star<#606#>int access(const~char &sstarf#star;fname, int mode);<#606#> =2000 to <#2759#> <#2760#>by -Check, if file <#2761#>#tex2html_accent_inline5398#<#2761#> is accessable with mode <#2762#>#tex2html_accent_inline5399#<#2762#>.<#2760#><#2759#>

func@star<#609#>unsigned~int alarm(unsigned~int sec);<#609#> =2000 to <#2763#> <#2764#>by -Instructs the alarm clock of the calling process to send the signal SIGALRM to the calling process after <#2765#>#tex2html_accent_inline5400#<#2765#> seconds<#2764#><#2763#>

func@star<#611#>int chdir(const~char &sstarf#star;dname);<#611#> =2000 to <#2766#> <#2767#>by -Chane the current working directory to <#2768#>#tex2html_accent_inline5401#<#2768#> including drive specification.<#2767#><#2766#>

func@star<#613#>int chmod(const~char &sstarf#star;fname, int mode);<#613#> =2000 to <#2769#> <#2770#>by -Change permissions of file <#2771#>#tex2html_accent_inline5402#<#2771#> to <#2772#>#tex2html_accent_inline5403#<#2772#>.<#2770#><#2769#>

func@star<#616#>int chown(const~char &sstarf#star;fname, int uid, int gid);<#616#> =2000 to <#2773#> <#2774#>by -Change owner and group of file <#2775#>#tex2html_accent_inline5404#<#2775#>. (Fake for now)<#2774#><#2773#>

func@star<#618#>int close(int fd);<#618#> =2000 to <#2776#> <#2777#>by -Close the file assosiated with file descriptor <#2778#>#tex2html_accent_inline5405#<#2778#>.<#2777#><#2776#>

func@star<#620#>int creat(const~char &sstarf#star;fname, unsigned mode);<#620#> =2000 to <#2779#> <#2780#>by -Create the file <#2781#>#tex2html_accent_inline5406#<#2781#> with mode <#2782#>#tex2html_accent_inline5407#<#2782#>.<#2780#><#2779#>

func@star<#623#>int dup(int fd);<#623#> =2000 to <#2783#> <#2784#>by -Duplicate filedescriptor <#2785#>#tex2html_accent_inline5408#<#2785#>.<#2784#><#2783#>

func@star<#625#>int dup2(int fd1, int fd2);<#625#> =2000 to <#2786#> <#2787#>by -Duplicate filedescriptor <#2788#>#tex2html_accent_inline5409#<#2788#> to <#2789#>#tex2html_accent_inline5410#<#2789#>.<#2787#><#2786#>

func@star<#628#>int execl(char &sstarf#star;path, …);<#628#> func@star<#2077#>int execle(char &sstarf#star;path, …, char <#629#>&sstarf#star;&sstarf#star;<#629#>envp);<#2077#> func@star<#630#>int execlp(char &sstarf#star;path, …);<#630#> =2000 to <#2790#> <#2791#>by -Execute a new process from <#2792#>#tex2html_accent_inline5414#<#2792#> after a <#2793#>#tex2html_accent_inline5415#<#2793#>, <#2794#>#tex2html_accent_inline5416#<#2794#> use the PATH environment.<#2791#><#2790#>

func@star<#2079#>int execv(char &sstarf#star;path, char <#634#>&sstarf#star;&sstarf#star;<#634#>argv);<#2079#> func@star<#2080#>int execvp(char &sstarf#star;path, char <#635#>&sstarf#star;&sstarf#star;<#635#>argv);<#2080#> func@star<#2081#>int execve(char &sstarf#star;path, char <#636#>&sstarf#star;&sstarf#star;<#636#>argv, char <#637#>&sstarf#star;&sstarf#star;<#637#>envp);<#2081#> =2000 to <#2795#> <#2796#>by -Execute a new process from <#2797#>#tex2html_accent_inline5417#<#2797#> after a <#2798#>#tex2html_accent_inline5418#<#2798#>, using the argv method. <#2799#>#tex2html_accent_inline5419#<#2799#> use the PATH environment.<#2796#><#2795#>

func@star<#641#>int fork();<#641#> func@star<#642#>int vfork();<#642#> =2000 to <#2800#> <#2801#>by -Simulate a non multitasking fork. <#2802#>#tex2html_accent_inline5420#<#2802#> shares data + stack with parent.<#2801#><#2800#>

func@star<#644#>char &sstarf#star;getcwd(char &sstarf#star;buf, int size);<#644#> func@star<#645#>char &sstarf#star;getwd(char &sstarf#star;buf);<#645#> =2000 to <#2803#> <#2804#>by -Get the current working directory.<#2804#><#2803#>

func@star<#647#>unsigned~short getgid();<#647#> func@star<#648#>unsigned~short getuid();<#648#> =2000 to <#2805#> <#2806#>by -Get user and group id's. (Fake for now, returning alsways root).<#2806#><#2805#>

func@star<#650#>unsigned~short getegid();<#650#> func@star<#651#>unsigned~short geteuid();<#651#> =2000 to <#2807#> <#2808#>by -Get effective user and group id's.<#2808#><#2807#>

func@star<#653#>int getgroups(int setlen, gid_t &sstarf#star;gidset);<#653#> =2000 to <#2809#> <#2810#>by -Retrieves the current group access list of the user process and stores it in <#2811#>#tex2html_accent_inline5421#<#2811#>.<#2810#><#2809#>

func@star<#655#>char &sstarf#star;getlogin();<#655#> =2000 to <#2812#> <#2813#>by -Return the user's login name. (Password file and environment are seached in order).<#2813#><#2812#>

func@star<#2085#>int getopt(int argc, const~char <#657#>&sstarf#star;&sstarf#star;<#657#>argv, const~char &sstarf#star;opt);<#2085#> =2000 to <#2814#> <#2815#>by -Extract the command line options described by <#2816#>#tex2html_accent_inline5422#<#2816#> from <#2817#>#tex2html_accent_inline5423#<#2817#>.<#2815#><#2814#>

func@star<#660#>int getpagesize (void);<#660#> =2000 to <#2818#> <#2819#>by -Get system page size<#2819#><#2818#>

func@star<#662#>char /*getpass(char *prompt);<#662#> =2000 to <#2820#> <#2821#>by -<#2821#><#2820#>

func@star<#664#>int getpgrp();<#664#> func@star<#665#>int setpgrp();<#665#> =2000 to <#2822#> <#2823#>by -Get or create a process group (This basically a fake; both return <#2824#>#tex2html_accent_inline5424#<#2824#>).<#2823#><#2822#>

func@star<#667#>int getpid();<#667#> func@star<#668#>int getppid();<#668#> func@star<#669#>int setpgid (pid_t pid, pid_t pgid);<#669#> =2000 to <#2825#> <#2826#>by -Return a process id for the currently running process (or the parent process) (from the basepage).<#2826#><#2825#>

func@star<#671#>char &sstarf#star;initstate(unsigned seed, char &sstarf#star;arg_state, int n);<#671#> =2000 to <#2827#> <#2828#>by -Initialize state array of generator for <#2829#>#tex2html_accent_inline5425#<#2829#>.<#2828#><#2827#>

func@star<#673#>int isatty(int fd);<#673#> =2000 to <#2830#> <#2831#>by -Check, if <#2832#>#tex2html_accent_inline5426#<#2832#> is associated with a terminal (screen).<#2831#><#2830#>

func@star<#675#>int link(const~char &sstarf#star;old , const~char &sstarf#star;new);<#675#> =2000 to <#2833#> <#2834#>by -Make a new link from <#2835#>#tex2html_accent_inline5427#<#2835#> to <#2836#>#tex2html_accent_inline5428#<#2836#>. Always fails.<#2834#><#2833#>

func@star<#678#>long lseek(int fd, long pos, int whence);<#678#> =2000 to <#2837#> <#2838#>by -Set the current file posistion to position <#2839#>#tex2html_accent_inline5429#<#2839#> relative to <#2840#>#tex2html_accent_inline5430#<#2840#>.<#2838#><#2837#>

func@star<#681#>int mkdir(const~char &sstarf#star;dname, unsigned mode);<#681#> =2000 to <#2841#> <#2842#>by -Make a directory with name <#2843#>#tex2html_accent_inline5431#<#2843#> and change its mode to <#2844#>#tex2html_accent_inline5432#<#2844#>.<#2842#><#2841#>

func@star<#684#>char &sstarf#star;mktemp(char &sstarf#star;pattern);<#684#> =2000 to <#2845#> <#2846#>by -Return a filename for a temporary file, build after <#2847#>#tex2html_accent_inline5433#<#2847#>.<#2846#><#2845#>

func@star<#686#>int open(const~char &sstarf#star;fname, int mode, …);<#686#> =2000 to <#2848#> <#2849#>by -Open the file <#2850#>#tex2html_accent_inline5435#<#2850#> with mode <#2851#>#tex2html_accent_inline5436#<#2851#>.<#2849#><#2848#>

func@star<#689#>long pathconf (const char &sstarf#star;path, int name);<#689#> =2000 to <#2852#> <#2853#>by -Get configurable pathname variables.<#2853#><#2852#>

<#2095#>=The following table lists the possible values for <#691#>#tex2html_accent_inline5437#<#691#>.

<#2095#>

;SPMnbsp;;SPMnbsp;;SPMnbsp;;SPMnbsp;##;SPMnbsp;;SPMnbsp;;SPMnbsp;;SPMnbsp;;SPMamp;##;SPMamp;;SPMnbsp;;SPMnbsp;;SPMnbsp;;SPMnbsp;##;SPMnbsp;;SPMnbsp;;SPMnbsp;;SPMnbsp; name;SPMamp;;SPMamp;Meaning <#694#>

func@star<#707#>int pause (void);<#707#> =2000 to <#2859#> <#2860#>by -Suspends the calling process until it receives a signal.<#2860#><#2859#>

func@star<#709#>int pipe (int &sstarf#star;fildes);<#709#> =2000 to <#2861#> <#2862#>by -Creates a pipe and returns two file descriptors. <#2863#>#tex2html_accent_inline5438#<#2863#> for reading, <#2864#>#tex2html_accent_inline5439#<#2864#> for writing.<#2862#><#2861#>

func@star<#712#>void psignal(int signal, const~char &sstarf#star;prefix);<#712#> =2000 to <#2865#> <#2866#>by -Print a error message describing the signal with a user comment.<#2866#><#2865#>

func@star<#714#>long random();<#714#> =2000 to <#2867#> <#2868#>by -Return a pseudo random number in the range from 0 to 2³1 - 1.<#2868#><#2867#>

func@star<#716#>int rmdir(const~char &sstarf#star;dname);<#716#> =2000 to <#2869#> <#2870#>by -Remove the directory with name <#2871#>#tex2html_accent_inline5441#<#2871#>.<#2870#><#2869#>

func@star<#718#>int read(int fd, void &sstarf#star;buf, unsigned cnt);<#718#> func@star<#719#>long _read(int fd, void &sstarf#star;buf, unsigned~long cnt);<#719#> =2000 to <#2872#> <#2873#>by -Read <#2874#>#tex2html_accent_inline5442#<#2874#> bytes from file descriptor <#2875#>#tex2html_accent_inline5443#<#2875#> into buffer <#2876#>#tex2html_accent_inline5444#<#2876#>.<#2873#><#2872#>

func@star<#723#>int readlink (char &sstarf#star;filenam, char &sstarf#star;linkto, int siz);<#723#> =2000 to <#2877#> <#2878#>by -Read value of a symbolic link<#2878#><#2877#>

func@star<#725#>void &sstarf#star;sbrk(unsigned~long size);<#725#> func@star<#726#>void &sstarf#star;lsbrk(long size);<#726#> =2000 to <#2879#> <#2880#>by -Emulation of the U&sstarf#star;ix <#2881#>#tex2html_accent_inline5445#<#2881#> system call.<#2880#><#2879#>

func@star<#728#>void setlinebuf(void &sstarf#star;fp);<#728#> =2000 to <#2882#> <#2883#>by -Change the buffering on stream <#2884#>#tex2html_accent_inline5446#<#2884#> from block/unbuffered to line buffered.<#2883#><#2882#>

func@star<#730#>int setgid(int gid);<#730#> func@star<#731#>int setuid(int uid);<#731#> =2000 to <#2885#> <#2886#>by -Set the real group or user id.<#2886#><#2885#>

func@star<#733#>int setegid(int gid);<#733#> func@star<#734#>int seteuid(int uid);<#734#> =2000 to <#2887#> <#2888#>by -Set the effective group or user id.<#2888#><#2887#>

func@star<#736#>int setregid (int rgid, int egid);<#736#> func@star<#737#>int setreuid (int ruid, int euid);<#737#> =2000 to <#2889#> <#2890#>by -Set real and effective group or user id.<#2890#><#2889#>

func@star<#739#>int setsid (void);<#739#> =2000 to <#2891#> <#2892#>by -Create session and set process group ids<#2892#><#2891#>

func@star<#741#>char &sstarf#star;setstate(char &sstarf#star;arg_state);<#741#> =2000 to <#2893#> <#2894#>by -Switch state of generator for <#2895#>#tex2html_accent_inline5447#<#2895#>.<#2894#><#2893#>

func@star<#743#>void sigpause(long mask);<#743#> =2000 to <#2896#> <#2897#>by -Suspends the calling process until it receives a signal.<#2897#><#2896#>

func@star<#745#>int sleep(int n);<#745#> =2000 to <#2898#> <#2899#>by -Sleep for <#2900#>#tex2html_accent_inline5448#<#2900#> number of seconds.<#2899#><#2898#>

func@star<#747#>int srandom(unsigned int x);<#747#> =2000 to <#2901#> <#2902#>by -Seed generator for <#2903#>#tex2html_accent_inline5449#<#2903#>.<#2902#><#2901#>

func@star<#749#>int stime(long &sstarf#star;time);<#749#> =2000 to <#2904#> <#2905#>by -Set the current time to <#2906#>#tex2html_accent_inline5450#<#2906#> in U&sstarf#star;ix format.<#2905#><#2904#>

func@star<#751#>int symlink (char &sstarf#star;oldname, char &sstarf#star;newname);<#751#> =2000 to <#2907#> <#2908#>by -Make symbolic link to a file<#2908#><#2907#>

func@star<#753#>long sysconf (int name);<#753#> =2000 to <#2909#> <#2910#>by -Get configurable system variables.<#2910#><#2909#>

<#2105#>=The following table lists the possible values for <#755#>#tex2html_accent_inline5451#<#755#>.

<#2105#>

;SPMnbsp;;SPMnbsp;;SPMnbsp;;SPMnbsp;##;SPMnbsp;;SPMnbsp;;SPMnbsp;;SPMnbsp;;SPMamp;##;SPMamp;;SPMnbsp;;SPMnbsp;;SPMnbsp;;SPMnbsp;##;SPMnbsp;;SPMnbsp;;SPMnbsp;;SPMnbsp; name;SPMamp;;SPMamp;Meaning <#758#>

func@star<#769#>long tell(int fd);<#769#> =2000 to <#2916#> <#2917#>by -Get the current file position of the file associated with <#2918#>#tex2html_accent_inline5452#<#2918#>.<#2917#><#2916#>

func@star<#771#>int times(struct tms &sstarf#star;buf);<#771#> =2000 to <#2919#> <#2920#>by -Get process times into <#2921#>#tex2html_accent_inline5453#<#2921#>.<#2920#><#2919#>

func@star<#773#>char &sstarf#star;ttyname(int file);<#773#> =2000 to <#2922#> <#2923#>by -<#2923#><#2922#>

func@star<#775#>int umask(int mode);<#775#> =2000 to <#2924#> <#2925#>by -Set access mask. (Fake for now)<#2925#><#2924#>

func@star<#777#>int unlink(const~char &sstarf#star;fname);<#777#> =2000 to <#2926#> <#2927#>by -Remove the file with name <#2928#>#tex2html_accent_inline5454#<#2928#>.<#2927#><#2926#>

func@star<#779#>void usleep(unsigned~long n);<#779#> =2000 to <#2929#> <#2930#>by -Sleep for <#2931#>#tex2html_accent_inline5455#<#2931#> number of milliseconds.<#2930#><#2929#>

func@star<#781#>int utime(const~char &sstarf#star;fname, const~struct utimbuf &sstarf#star;ftime);<#781#> =2000 to <#2932#> <#2933#>by -Set the modification time and date of file <#2934#>#tex2html_accent_inline5456#<#2934#> to <#2935#>#tex2html_accent_inline5457#<#2935#>.<#2933#><#2932#>

func@star<#784#>int write(int fd, const~void &sstarf#star;buf, unsigned cnt);<#784#> func@star<#785#>long _write(int fd, const~void &sstarf#star;buf, unsigned~long cnt);<#785#> =2000 to <#2936#> <#2937#>by -Write <#2938#>#tex2html_accent_inline5458#<#2938#> bytes from buffer <#2939#>#tex2html_accent_inline5459#<#2939#> to file descriptor <#2940#>#tex2html_accent_inline5460#<#2940#>.<#2937#><#2936#>

func@star<#789#>int wait(int &sstarf#star;exit_code);<#789#> =2000 to <#2941#> <#2942#>by -Wait for child process.<#2942#><#2941#>

<#2943#>Password and Group Handling<#2943#>

<#2944#>#tex2html_accent_inline5461#<#2944#><#2946#>section<#2946#><#2947#>Password and Group Handling<#2947#><#2948#><#2948#>

#include pwd.h;SPMgt;

func@star<#792#>void endpwent();<#792#> =2000 to <#2949#> <#2950#>by -Close password file.<#2950#><#2949#>

func@star<#794#>struct~passwd &sstarf#star;getpwent();<#794#> =2000 to <#2951#> <#2952#>by -Return an entry from the password file.<#2952#><#2951#>

func@star<#796#>struct~passwd &sstarf#star;getpwuid(int uid);<#796#> =2000 to <#2953#> <#2954#>by -Return the entry from the password file for <#2955#>#tex2html_accent_inline5462#<#2955#>.<#2954#><#2953#>

func@star<#798#>struct~passwd &sstarf#star;getpwnam(const~char &sstarf#star;user);<#798#> =2000 to <#2956#> <#2957#>by -Return the entry from the password file for <#2958#>#tex2html_accent_inline5463#<#2958#>.<#2957#><#2956#>

func@star<#800#>void setpwent();<#800#> =2000 to <#2959#> <#2960#>by -Open password file for further operations.<#2960#><#2959#>

func@star<#802#>void setpwfile(char &sstarf#star;fname);<#802#> =2000 to <#2961#> <#2962#>by -Use the <#2963#>#tex2html_accent_inline5464#<#2963#> instead of <#2964#>#tex2html_accent_inline5465#<#2964#> as password file.<#2962#><#2961#>

#include grp.h;SPMgt;

func@star<#805#>void endgrent();<#805#> =2000 to <#2965#> <#2966#>by -Close group file.<#2966#><#2965#>

func@star<#807#>struct~group &sstarf#star;getgrent()<#807#> =2000 to <#2967#> <#2968#>by -Return an entry from the group file.<#2968#><#2967#>

func@star<#809#>struct~group &sstarf#star;getgrgid(int gid);<#809#> =2000 to <#2969#> <#2970#>by -Return the entry from the group file for <#2971#>#tex2html_accent_inline5466#<#2971#>. (Mostly fake, returning root or user as groupnames)<#2970#><#2969#>

func@star<#811#>struct~group &sstarf#star;getgrnam(char &sstarf#star;gname);<#811#> =2000 to <#2972#> <#2973#>by -Return the entry from the group file for <#2974#>#tex2html_accent_inline5467#<#2974#>. (Mostly fake, returning root or user as groupnames)<#2973#><#2972#>

<#2975#>Value Conversion<#2975#>

<#2976#>#tex2html_accent_inline5468#<#2976#><#2978#>section<#2978#><#2979#>Value Conversion<#2979#><#2980#><#2980#>

#include stdlib.h;SPMgt;

func@star<#814#>double atof(const~char &sstarf#star;str);<#814#> =2000 to <#2981#> <#2982#>by -Return double value of number presented in <#2983#>#tex2html_accent_inline5469#<#2983#>.<#2982#><#2981#>

func@star<#816#>int atoi(const~char &sstarf#star;str);<#816#> =2000 to <#2984#> <#2985#>by -Return int value of number presented in <#2986#>#tex2html_accent_inline5470#<#2986#>.<#2985#><#2984#>

func@star<#818#>long atol(const~char &sstarf#star;str);<#818#> =2000 to <#2987#> <#2988#>by -Return long value of number presented in <#2989#>#tex2html_accent_inline5471#<#2989#>.<#2988#><#2987#>

func@star<#820#>int abs(int val);<#820#> func@star<#821#>long labs(long val);<#821#> =2000 to <#2990#> <#2991#>by -Return absolute value of <#2992#>#tex2html_accent_inline5472#<#2992#>.<#2991#><#2990#>

func@star<#2121#>long strtol(const~char &sstarf#star;nptr, char <#823#>&sstarf#star;&sstarf#star;<#823#>endptr, int base);<#2121#> func@star<#2122#>unsigned~long strtoul(const~char &sstarf#star;nptr, char <#824#>&sstarf#star;&sstarf#star;<#824#>endptr, int base);<#2122#> =2000 to <#2993#> <#2994#>by -Return the value of the number in <#2995#>#tex2html_accent_inline5473#<#2995#> with <#2996#>#tex2html_accent_inline5474#<#2996#> putting the endaddress of the numerical string into <#2997#>#tex2html_accent_inline5475#<#2997#>.<#2994#><#2993#>

func@star<#2124#>double strtod(const~char &sstarf#star;nptr, char <#828#>&sstarf#star;&sstarf#star;<#828#>endptr);<#2124#> =2000 to <#2998#> <#2999#>by -Return the double value of the number in <#3000#>#tex2html_accent_inline5476#<#3000#> putting the endaddress of the numerical string into <#3001#>#tex2html_accent_inline5477#<#3001#>.<#2999#><#2998#>

#include support.h;SPMgt;

func@star<#831#>char &sstarf#star;_itoa(int val, char &sstarf#star;buf, int radix);<#831#> func@star<#832#>char &sstarf#star;_ltoa(long val, char &sstarf#star;buf, int radix);<#832#> func@star<#833#>char &sstarf#star;_ultoa(unsigned long val, char &sstarf#star;buf, int radix);<#833#> =2000 to <#3002#> <#3003#>by -Convert the value <#3004#>#tex2html_accent_inline5478#<#3004#> to a string in <#3005#>#tex2html_accent_inline5479#<#3005#> according to <#3006#>#tex2html_accent_inline5480#<#3006#>.<#3003#><#3002#>

#include locale.h;SPMgt;

func@star<#837#>struct~lconv &sstarf#star;localeconv();<#837#> =2000 to <#3007#> <#3008#>by -Get rules of the current locale<#3008#><#3007#>

func@star<#839#>char &sstarf#star;setlocale(int category , const~char &sstarf#star;name);<#839#> =2000 to <#3009#> <#3010#>by -Define locale named in <#3011#>#tex2html_accent_inline5481#<#3011#>.<#3010#><#3009#>

<#3012#>Miscellaneous<#3012#>

<#3013#>#tex2html_accent_inline5482#<#3013#><#3015#>section<#3015#><#3016#>Miscellaneous<#3016#><#3017#><#3017#>

func@star<#842#>int _text_read(int fd, char &sstarf#star;buf, int bytes);<#842#> func@star<#843#>int _text_write(int fd, char &sstarf#star;buf, int bytes);<#843#> =2000 to <#3018#> <#3019#>by -The same as <#3020#>#tex2html_accent_inline5483#<#3020#>() and <#3021#>#tex2html_accent_inline5484#<#3021#>(), except the CR character is discarded on input and inserted on output.<#3019#><#3018#>

#include stdlib.h;SPMgt;

func@star<#846#>void &sstarf#star;bsearch(const~void &sstarf#star;key, const~void &sstarf#star;base, size_t num, size_t size, int (&sstarf#star;cmp)());<#846#> =2000 to <#3022#> <#3023#>by -Binary search a field starting at <#3024#>#tex2html_accent_inline5485#<#3024#> with <#3025#>#tex2html_accent_inline5486#<#3025#> elements each size <#3026#>#tex2html_accent_inline5487#<#3026#> for <#3027#>#tex2html_accent_inline5488#<#3027#>.<#3023#><#3022#>

func@star<#851#>div_t div(int num, int denom);<#851#> func@star<#852#>ldiv_t ldiv(long num, long denom);<#852#> =2000 to <#3028#> <#3029#>by -Perform division and return both quotient and remainder.<#3029#><#3028#>

func@star<#854#>char &sstarf#star;getenv(const~char &sstarf#star;name);<#854#> =2000 to <#3030#> <#3031#>by -Get the contents of the environment variable <#3032#>#tex2html_accent_inline5489#<#3032#>.<#3031#><#3030#>

func@star<#856#>void qsort(void &sstarf#star;base, size_t num, size_t size, int (&sstarf#star;cmp)());<#856#> =2000 to <#3033#> <#3034#>by -Quick sort an array of <#3035#>#tex2html_accent_inline5490#<#3035#> elements with size <#3036#>#tex2html_accent_inline5491#<#3036#> starting at <#3037#>#tex2html_accent_inline5492#<#3037#>.<#3034#><#3033#>

func@star<#860#>int rand();<#860#> =2000 to <#3038#> <#3039#>by -Return a pseudo random number in the range from 0 to <#3040#>#tex2html_accent_inline5493#<#3040#>.<#3039#><#3038#>

func@star<#862#>void srand(unsigned int seed);<#862#> =2000 to <#3041#> <#3042#>by -Use <#3043#>#tex2html_accent_inline5494#<#3043#> to initialize the pseudo-random number generator.<#3042#><#3041#>

#include keycodes.h;SPMgt;

func@star<#864#>int console_input_status(int handle);<#864#> =2000 to <#3044#> <#3045#>by -Check, if character is available from standart CON:. (This is the same as <#3046#>#tex2html_accent_inline5495#<#3046#>)<#3045#><#3044#>

func@star<#866#>unsigned~int console_read_byte(int handle);<#866#> =2000 to <#3047#> <#3048#>by -Raw input from standart CON: without echoing to screen. (This is the same as <#3049#>#tex2html_accent_inline5496#<#3049#>)<#3048#><#3047#>

func@star<#868#>void console_write_byte(int handle, int character);<#868#> =2000 to <#3050#> <#3051#>by -Write character <#3052#>#tex2html_accent_inline5497#<#3052#> to handle <#3053#>#tex2html_accent_inline5498#<#3053#>. (This is a <#3054#>#tex2html_accent_inline5499#<#3054#> with count 1)<#3051#><#3050#>

#include support.h;SPMgt;

func@star<#872#>void dos2unx(const~char &sstarf#star;t_fname, char &sstarf#star;u_fname);<#872#> =2000 to <#3055#> <#3056#>by -Convert filenames from TOS format to U&sstarf#star;ix format.<#3056#><#3055#>

func@star<#874#>time_t dostime(time_t);<#874#> =2000 to <#3057#> <#3058#>by -Convert U&sstarf#star;ix time to TOS time and date (lower word = time, upper word = date).<#3058#><#3057#>

func@star<#2137#>char &sstarf#star;findfile(char &sstarf#star;fname, char &sstarf#star;path, char <#876#>&sstarf#star;&sstarf#star;<#876#>ext);<#2137#> =2000 to <#3059#> <#3060#>by -Locate the file <#3061#>#tex2html_accent_inline5500#<#3061#> along the paths in <#3062#>#tex2html_accent_inline5501#<#3062#> with <#3063#>#tex2html_accent_inline5502#<#3063#> containing possible extensions.<#3060#><#3059#>

func@star<#880#>void fnmapfunc(fnmapfunc_t u2dos, fnmapfunc_t dos2u);<#880#> =2000 to <#3064#> <#3065#>by -Set mapping functions for the <#3066#>#tex2html_accent_inline5503#<#3066#> and <#3067#>#tex2html_accent_inline5504#<#3067#> routines.<#3065#><#3064#>

func@star<#883#>int symlink(char &sstarf#star;old , char &sstarf#star;new);<#883#> =2000 to <#3068#> <#3069#>by -Make a new symbolic link from <#3070#>#tex2html_accent_inline5505#<#3070#> to <#3071#>#tex2html_accent_inline5506#<#3071#>. Env. UNIXMODE determines behavior.<#3069#><#3068#>

func@star<#886#>int readlink(char &sstarf#star;fname , char &sstarf#star;buf, int siz);<#886#> =2000 to <#3072#> <#3073#>by -Read the link for <#3074#>#tex2html_accent_inline5507#<#3074#> into <#3075#>#tex2html_accent_inline5508#<#3075#>.<#3073#><#3072#>

func@star<#889#>time_t unixtime(unsigned tostime, unsigned tosdate);<#889#> =2000 to <#3076#> <#3077#>by -Convert a TOS time/date pair into a U&sstarf#star;ix time.<#3077#><#3076#>

func@star<#891#>void unx2dos(const~char &sstarf#star;u_fname, char &sstarf#star;t_fname);<#891#> =2000 to <#3078#> <#3079#>by -Convert filenames from U&sstarf#star;ix format to TOS format.<#3079#><#3078#>

func@star<#893#>void _set_unixmode(char &sstarf#star;mode);<#893#> =2000 to <#3080#> <#3081#>by -Set features of the extended file system.<#3081#><#3080#>

func@star<#895#>void _uniquefy(char &sstarf#star;dos);<#895#> =2000 to <#3082#> <#3083#>by -Make an unigue TOS filename for the extended file system.<#3083#><#3082#>

#include sysvars.h;SPMgt;

func@star<#897#>long get_sysvar(void &sstarf#star;var);<#897#> =2000 to <#3084#> <#3085#>by -Get the contents of the system variable <#3086#>#tex2html_accent_inline5509#<#3086#>.<#3085#><#3084#>

func@star<#899#>void set_sysvar_to_long(void &sstarf#star;var, long val);<#899#> =2000 to <#3087#> <#3088#>by -Set the system variable <#3089#>#tex2html_accent_inline5510#<#3089#> to the long value <#3090#>#tex2html_accent_inline5511#<#3090#>.<#3088#><#3087#>

<#3091#>Profiling<#3091#>

<#3092#>#tex2html_accent_inline5512#<#3092#><#3094#>section<#3094#><#3095#>Profiling<#3095#><#3096#><#3096#>

#include support.h;SPMgt;

also see <#903#>#tex2html_accent_inline5513#<#903#> and <#904#>#tex2html_accent_inline5514#<#904#> option to <#905#>#tex2html_accent_inline5515#<#905#>

func@star<#906#>void monstartup(void &sstarf#star;lpc, void &sstarf#star;hpc);<#906#> =2000 to <#3097#> <#3098#>by -High level interface to <#3099#>#tex2html_accent_inline5516#<#3099#>. <#3100#>#tex2html_accent_inline5517#<#3100#> is the range to sample. Necessary memory is dynamically allocated.<#3098#><#3097#>

func@star<#909#>void monitor(void &sstarf#star;lpc, void &sstarf#star;hpc, void &sstarf#star;buf, size_t bsiz, unsigned int nfunc);<#909#> =2000 to <#3101#> <#3102#>by -Low level interface to profil. <#3103#>#tex2html_accent_inline5518#<#3103#> is a user supplied buffer. PC samples over <#3104#>#tex2html_accent_inline5519#<#3104#> and <#3105#>#tex2html_accent_inline5520#<#3105#> call records are accumulated in <#3106#>#tex2html_accent_inline5521#<#3106#>.<#3102#><#3101#>

func@star<#914#>void moncontrol(long flag);<#914#> =2000 to <#3107#> <#3108#>by -Selectively control profiling in a program.<#3108#><#3107#>

func@star<#916#>int profil(void &sstarf#star;buf, unsigned~long bsiz, unsigned~long off, int shift);<#916#> =2000 to <#3109#> <#3110#>by -Execution time profil. Pc is examined every 20ms, (PC-off)#tex2html_wrap_inline5523#⇧ shift if in range, will increment short in <#3111#>#tex2html_accent_inline5524#<#3111#>.<#3110#><#3109#>

<#3112#>Mathematical Functions<#3112#>

<#3113#>#tex2html_accent_inline5525#<#3113#><#3115#>section<#3115#><#3116#>Mathematical Functions<#3116#><#3117#><#3117#>

#include math.h;SPMgt;

func@star<#919#>double acos(double);<#919#> func@star<#920#>double acosh(double);<#920#> func@star<#921#>double asin(double);<#921#> func@star<#922#>double asinh(double);<#922#> func@star<#923#>double atan(double);<#923#> func@star<#924#>double atan2(double, double);<#924#> func@star<#925#>double atanh(double);<#925#> func@star<#926#>double ceil(double);<#926#> func@star<#927#>double copysign(double, double);<#927#> func@star<#928#>double cos(double);<#928#> func@star<#929#>double cosh(double);<#929#> func@star<#930#>double dabs(double);<#930#> func@star<#931#>double exp(double);<#931#> func@star<#932#>double fabs(double);<#932#> func@star<#933#>double floor(double);<#933#> func@star<#934#>double fmod(double, double);<#934#> func@star<#935#>double frexp(double, int &sstarf#star;);<#935#> func@star<#936#>double ldexp(double, int);<#936#> func@star<#937#>double log(double);<#937#> func@star<#938#>double log10(double);<#938#> func@star<#939#>double modf(double, double &sstarf#star;);<#939#> func@star<#940#>double poly(int, double &sstarf#star;, double);<#940#> func@star<#941#>double pow(double, double);<#941#> func@star<#942#>double rint(double);<#942#> func@star<#943#>double sin(double);<#943#> func@star<#944#>double sinh(double);<#944#> func@star<#945#>double sqrt(double);<#945#> func@star<#946#>double tan(double);<#946#> func@star<#947#>double tanh(double);<#947#>

func@star<#948#>int matherr(struct exception &sstarf#star;);<#948#> func@star<#949#>int pmlcfs(int, int);<#949#> func@star<#950#>int pmlcnt(void);<#950#> func@star<#951#>int pmlerr(int);<#951#> func@star<#952#>int pmllim(int);<#952#> func@star<#953#>int pmlsfs(int, int);<#953#>

<#3118#>GEMDOS Calls via Trap 1<#3118#>

<#3119#>#tex2html_accent_inline5526#<#3119#><#3121#>section<#3121#><#3122#>GEMDOS Calls via Trap 1<#3122#><#3123#><#3123#>

#include osbind.h;SPMgt;

The following assignment is valid by default:

#1##2##3<#3125#>##1;SPMamp;;SPMamp;##2;SPMamp;;SPMamp;##3<#3125#> ;SPMnbsp;;SPMnbsp;;SPMnbsp;;SPMnbsp;##;SPMnbsp;;SPMnbsp;;SPMnbsp;;SPMnbsp;;SPMamp;##;SPMamp; ;SPMnbsp;;SPMnbsp;;SPMnbsp;;SPMnbsp;##;SPMnbsp;;SPMnbsp;;SPMnbsp;;SPMnbsp;;SPMamp;##;SPMamp;;SPMnbsp;;SPMnbsp;;SPMnbsp;;SPMnbsp;## ;SPMamp;Device;SPMamp;;SPMamp;handle;SPMamp;;SPMamp;;SPMamp; <#958#>

func@star<#971#>long Cauxin();<#971#> =2000 to <#3127#> <#3128#>by -Read character from standart AUX:.<#3128#><#3127#>

func@star<#973#>short Cauxis();<#973#> =2000 to <#3129#> <#3130#>by -Check, if character is available from standart AUX:.<#3130#><#3129#>

func@star<#975#>short Cauxos();<#975#> =2000 to <#3131#> <#3132#>by -Check, if character can be written to standart AUX:.<#3132#><#3131#>

func@star<#977#>void Cauxout(short c);<#977#> =2000 to <#3133#> <#3134#>by -Write character <#3135#>#tex2html_accent_inline5527#<#3135#> to standart AUX:.<#3134#><#3133#>

func@star<#979#>long Cconin();<#979#> =2000 to <#3136#> <#3137#>by -Read a character from standart CON:.<#3137#><#3136#>

func@star<#981#>short Cconis();<#981#> =2000 to <#3138#> <#3139#>by -Check, if character is available from standart CON:.<#3139#><#3138#>

func@star<#983#>short Cconos();<#983#> =2000 to <#3140#> <#3141#>by -Check, if character can be written to standart CON:.<#3141#><#3140#>

func@star<#985#>void Cconout(short c);<#985#> =2000 to <#3142#> <#3143#>by -Write character <#3144#>#tex2html_accent_inline5528#<#3144#> to standart CON:.<#3143#><#3142#>

func@star<#987#>void Cconrs(char &sstarf#star;buf);<#987#> =2000 to <#3145#> <#3146#>by -Read edited data from standart CON:. <#3147#>#tex2html_accent_inline5529#<#3147#> contains number of characters minus 1 to read.<#3146#><#3145#>

func@star<#989#>void Cconws(const~char &sstarf#star;str);<#989#> =2000 to <#3148#> <#3149#>by -Write string <#3150#>#tex2html_accent_inline5530#<#3150#> to standart CON:.<#3149#><#3148#>

func@star<#991#>long Cnecin();<#991#> =2000 to <#3151#> <#3152#>by -Raw input from standart CON: without echoing to screen, but with interpretation of CTRL-S, CRTL-Q and CRTL-C.<#3152#><#3151#>

func@star<#993#>short Cprnos();<#993#> =2000 to <#3153#> <#3154#>by -Check, if character can be written to standart PRN:.<#3154#><#3153#>

func@star<#995#>void Cprnout(short c);<#995#> =2000 to <#3155#> <#3156#>by -Write character <#3157#>#tex2html_accent_inline5531#<#3157#> to standart PRN:.<#3156#><#3155#>

func@star<#997#>long Crawcin();<#997#> =2000 to <#3158#> <#3159#>by -Raw input from standart CON: without echoing to screen.<#3159#><#3158#>

func@star<#999#>long Crawio(short data);<#999#> =2000 to <#3160#> <#3161#>by -Raw I/O to standart CON:. If <#3162#>#tex2html_accent_inline5532#<#3162#> = 0xff read from CON:, otherwise output to CON:.<#3161#><#3160#>

func@star<#1001#>short Dcreate(const~char &sstarf#star;dname);<#1001#> =2000 to <#3163#> <#3164#>by -Create a directory with name <#3165#>#tex2html_accent_inline5533#<#3165#>.<#3164#><#3163#>

func@star<#1003#>long Ddelete(const~char &sstarf#star;dname);<#1003#> =2000 to <#3166#> <#3167#>by -Remove a directory with name <#3168#>#tex2html_accent_inline5534#<#3168#>.<#3167#><#3166#>

func@star<#1005#>long Dfree(DISKINFO &sstarf#star;buf, short drv);<#1005#> =2000 to <#3169#> <#3170#>by -Get available space of drive <#3171#>#tex2html_accent_inline5535#<#3171#> into <#3172#>#tex2html_accent_inline5536#<#3172#>. <#3173#>#tex2html_accent_inline5537#<#3173#> = 0 means current drive.<#3170#><#3169#>

func@star<#1009#>short Dgetdrv();<#1009#> =2000 to <#3174#> <#3175#>by -Get the number of the default drive.<#3175#><#3174#>

func@star<#1011#>long Dgetpath(void &sstarf#star;buf, short drv);<#1011#> =2000 to <#3176#> <#3177#>by -Get the current directory of drive <#3178#>#tex2html_accent_inline5538#<#3178#>. <#3179#>#tex2html_accent_inline5539#<#3179#> = 0 means current drive.<#3177#><#3176#>

func@star<#1014#>long Dsetdrv(short d);<#1014#> =2000 to <#3180#> <#3181#>by -Set the number of the default drive.<#3181#><#3180#>

func@star<#1016#>long Dsetpath(const~char &sstarf#star;path);<#1016#> =2000 to <#3182#> <#3183#>by -Set path for current drive to <#3184#>#tex2html_accent_inline5540#<#3184#>.<#3183#><#3182#>

func@star<#1018#>short Fattrib(const~char &sstarf#star;fname, short rwflag, short attr);<#1018#> =2000 to <#3185#> <#3186#>by -Get (<#3187#>#tex2html_accent_inline5541#<#3187#> = 0) or set (<#3188#>#tex2html_accent_inline5542#<#3188#> = 1) attribute byte of file <#3189#>#tex2html_accent_inline5543#<#3189#>.<#3186#><#3185#>

func@star<#1022#>long Fclose(short handle);<#1022#> =2000 to <#3190#> <#3191#>by -Close the file assosiated with <#3192#>#tex2html_accent_inline5544#<#3192#>.<#3191#><#3190#>

func@star<#1024#>struct~_dta &sstarf#star;Fgetdta();<#1024#> =2000 to <#3193#> <#3194#>by -Get the current disk transfer address.<#3194#><#3193#>

func@star<#1026#>long Fcreate(const~char &sstarf#star;fname, short mode);<#1026#> =2000 to <#3195#> <#3196#>by -Create file <#3197#>#tex2html_accent_inline5545#<#3197#> with mode <#3198#>#tex2html_accent_inline5546#<#3198#>.<#3196#><#3195#>

func@star<#1029#>long Fdatime(DOSTIME &sstarf#star;timeptr, short hdl, short rwflg);<#1029#> =2000 to <#3199#> <#3200#>by -Get (<#3201#>#tex2html_accent_inline5547#<#3201#> = 0) or set (<#3202#>#tex2html_accent_inline5548#<#3202#> = 1) the time structure of the file associated by handle <#3203#>#tex2html_accent_inline5549#<#3203#>.<#3200#><#3199#>

func@star<#1033#>long Fdelete(const~char &sstarf#star;fname);<#1033#> =2000 to <#3204#> <#3205#>by -Delete file with name <#3206#>#tex2html_accent_inline5550#<#3206#>.<#3205#><#3204#>

func@star<#1035#>long Fdup(short handle);<#1035#> =2000 to <#3207#> <#3208#>by -Return a second handle for a standart handle (0…5).<#3208#><#3207#>

func@star<#1037#>long Fforce(short Hstd, short Hnew);<#1037#> =2000 to <#3209#> <#3210#>by -Replace one of the standart handles (0…5) with <#3211#>#tex2html_accent_inline5553#<#3211#>.<#3210#><#3209#>

func@star<#1039#>long Fopen(const~char &sstarf#star;fname, short mode);<#1039#> =2000 to <#3212#> <#3213#>by -Open file <#3214#>#tex2html_accent_inline5554#<#3214#> with mode <#3215#>#tex2html_accent_inline5555#<#3215#>.<#3213#><#3212#>

func@star<#1042#>long Fread(short handle, long cnt, void &sstarf#star;buf);<#1042#> =2000 to <#3216#> <#3217#>by -Read <#3218#>#tex2html_accent_inline5556#<#3218#> bytes into <#3219#>#tex2html_accent_inline5557#<#3219#> from file assosiated with <#3220#>#tex2html_accent_inline5558#<#3220#>.<#3217#><#3216#>

func@star<#1046#>short Frename(const~char &sstarf#star;old, const~char &sstarf#star;new);<#1046#> =2000 to <#3221#> <#3222#>by -Change name of file from <#3223#>#tex2html_accent_inline5559#<#3223#> to <#3224#>#tex2html_accent_inline5560#<#3224#>. Also directories<#3222#><#3221#>

func@star<#1049#>long Fseek(long pos, short handle, short whence);<#1049#> =2000 to <#3225#> <#3226#>by -Set access pointer to position <#3227#>#tex2html_accent_inline5561#<#3227#> relative to <#3228#>#tex2html_accent_inline5562#<#3228#>.<#3226#><#3225#>

func@star<#1052#>void Fsetdta(struct _dta &sstarf#star;ptr);<#1052#> =2000 to <#3229#> <#3230#>by -Set the current disk tranfer address to <#3231#>#tex2html_accent_inline5563#<#3231#>.<#3230#><#3229#>

func@star<#1054#>long Fsfirst(const~char &sstarf#star;filespec, short attr);<#1054#> =2000 to <#3232#> <#3233#>by -Get first directory slot, which matches <#3234#>#tex2html_accent_inline5564#<#3234#> and <#3235#>#tex2html_accent_inline5565#<#3235#>.<#3233#><#3232#>

func@star<#1057#>long Fsnext();<#1057#> =2000 to <#3236#> <#3237#>by -Get next match of search started by <#3238#>#tex2html_accent_inline5566#<#3238#>.<#3237#><#3236#>

func@star<#1059#>long Fwrite(short handle, long cnt, const~void &sstarf#star;buf);<#1059#> =2000 to <#3239#> <#3240#>by -Write <#3241#>#tex2html_accent_inline5567#<#3241#> bytes from <#3242#>#tex2html_accent_inline5568#<#3242#> to file assosiated with <#3243#>#tex2html_accent_inline5569#<#3243#>.<#3240#><#3239#>

func@star<#1063#>long Malloc(long size);<#1063#> =2000 to <#3244#> <#3245#>by -Allocate <#3246#>#tex2html_accent_inline5570#<#3246#> bytes of memory.<#3245#><#3244#>

func@star<#1065#>long Mfree(void &sstarf#star;ptr);<#1065#> =2000 to <#3247#> <#3248#>by -Release block of memory.<#3248#><#3247#>

func@star<#1067#>long Mshrink(long ptr, long size);<#1067#> =2000 to <#3249#> <#3250#>by -Shrink size of memory block obtained by <#3251#>#tex2html_accent_inline5571#<#3251#>.<#3250#><#3249#>

func@star<#2174#>long Pexec(short mode, const~char &sstarf#star;prog, const~char &sstarf#star;tail, char <#1069#>&sstarf#star;&sstarf#star;<#1069#>env);<#2174#> =2000 to <#3252#> <#3253#>by -Execute <#3254#>#tex2html_accent_inline5572#<#3254#> with mode <#3255#>#tex2html_accent_inline5573#<#3255#>. The following bits in the <#3256#>#tex2html_accent_inline5574#<#3256#> of the programm header modify behaviour:<#3253#><#3252#>

= ;SPMnbsp;;SPMnbsp;;SPMnbsp;;SPMnbsp;##;SPMnbsp;;SPMnbsp;;SPMnbsp;;SPMnbsp;;SPMamp;##;SPMamp;;SPMnbsp;;SPMnbsp;;SPMnbsp;;SPMnbsp;##;SPMnbsp;;SPMnbsp;;SPMnbsp;;SPMnbsp; Bit;SPMamp;;SPMamp;Meaning <#1075#>